سرویس «استعلام اتباع خارجی» در دسته احراز هویت و شناخت مشتری فینوتک، با گرفتن شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد شامل نام و نام خانوادگی، نام پدر، نام جد، جنسیت، ملیت و مشخصات سند شناسایی او را برمیگرداند. با این خروجی میتوانید هویت مشتری غیرایرانی را پیش از ارائه خدمت، بدون اتکا به تصویر مدرک، راستیآزمایی کنید.
احراز هویت اتباع خارجی در بیشتر کسبوکارها هنوز فرآیندی کاغذی است: مشتری تصویر کارت یا برگه اقامت را میآورد، کارشناس آن را نگاه میکند و اطلاعات را دستی در سامانه وارد میکند. در این مسیر، هم خطای تایپ در نام و ملیت زیاد است، هم امکان تشخیص مدرک نامعتبر عملا وجود ندارد، و هم فرآیند پذیرش مشتری چند روز طول میکشد. برای کسبوکارهایی که موظفاند سوابق هویتی قابل دفاع نگه دارند، این روش ریسک انطباق ایجاد میکند.
استعلام اتباع خارجی چیست؟
سرویسی است که با دریافت شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد غیرایرانی شامل نام، نام خانوادگی، نام پدر، نام جد، جنسیت، ملیت و مشخصات سند شناسایی او را بهصورت داده ساختیافته برمیگرداند.
تفاوت این سرویس با استعلام اطلاعات هویتی چیست؟
ورودی این سرویس شناسه تبعه است و برای افراد غیرایرانی به کار میرود؛ برای افراد دارای کد ملی از استعلام اطلاعات هویتی استفاده کنید.
چه اطلاعاتی درباره سند شناسایی فرد برمیگردد؟
عنوان نوع سند شناسایی و شماره آن در پاسخ میآید. شرح دقیق خروجی در مستندات فنی آمده است.
آیا برای فراخوانی به تاریخ تولد نیاز است؟
بله؛ تاریخ تولد در کنار شناسه تبعه ورودی الزامی است و باید در قالب yyyy/mm/dd ارسال شود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.